总览
本章节范围：agent 怎么调外部能力——工具设计、MCP 协议、工具发现、代码执行 目标读者：给 agent 接工具、设计工具系统的工程师
范围与边界 (Scope)
- 包含：工具设计原则、MCP 协议、工具发现与延迟加载、代码执行 vs 工具编排
- 不包含：
- system prompt 里怎么写工具使用规范 → 02-上下文工程/03
- MCP 安全与 prompt injection → 07-安全与沙箱
- 多 agent 编排拓扑 → 04-编排与工作流
名词定义
| 名词 | 定义 |
|---|---|
| MCP (Model Context Protocol) | AI 应用接外部工具/服务的开放协议，"USB-C for AI" |
| Host / Client / Server | MCP 三层：应用本体 / 1:1 连接组件 / 暴露能力的程序 |
| Tools / Resources / Prompts | MCP Server 三原语：可调动作 / 可读数据 / 提示模板 |
| ACI (Agent-Computer Interface) | agent 与工具的接口设计，类比人机界面 HCI |
| poka-yoke （防呆） | 用接口结构约束让错误调用不可能发生 |
| 工具爆炸 | 连接多 server 致工具数量膨胀、占满上下文、降低选择准确率 |
| 延迟加载 | 按需加载工具 schema 而非全量注入 |
| 代码执行 (code execution) | 模型写代码在沙箱串调工具，只回最终结果 |
| subagent-as-tool | 把子 agent 当工具调用，隔离上下文 + 并行 |
@tbl-agent-tool-glossary 工具系统与 MCP 章节核心名词定义：MCP 三层架构、三原语、ACI、poka-yoke、工具爆炸、延迟加载、代码执行、subagent-as-tool
本章节所有文档默认这些名词已定义。
子文档索引 (Index)
- 02-工具设计原则 — 粒度、描述即文档、token 高效返回、poka-yoke 防呆
- 03-MCP-协议 — Host/Client/Server、JSON-RPC、传输、Tools/Resources/Prompts
- 04-工具发现与延迟加载 — 工具爆炸、分页懒取、语义检索路由
- 05-代码执行vs工具编排 — 写代码串调、98.7% token 节省、subagent-as-tool
参考资料
- Anthropic. Writing effective tools for agents / Code execution with MCP. 2025.
- MCP Specification. modelcontextprotocol.io. 2025.
- 各子文档
## 参考资料段含完整引用。